BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / pc_board / adlg17b.zip / ADLOGO.DOC < prev next >

Wrap

Text File | 1992-02-13 | 18KB | 434 lines

▒▒▒▒▒▒ ▒▒▄ ▒▒█▀▀▀▀▀▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▄ ▒▒█ ▒▒█ ▒▒█ ▒█ ▒▒█ ▒▒█ ▒▒█ ▒█ ▒▒█ ▒▒▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒█ ▒▒█ ▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▄ ▒▒██████▒▒█ ▒█▀▀▀▀▒█ ▒▒█ ▒█▀▀▀▀▒█ ▒█▀▀▀▀▒█ ▒█▀▀▀▀▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒█ ▀▀ ▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▒█ ▀▀▀▀▀▀▀ ▒█ ▒▒▒▒▒▒█ ▀▀▀▀▀▀ AdLogo v1.4ßeta Page 1 AdLogo v1.4ßeta by Michael J. Cambra Licensed to TMC SoftWare/OTS Software Development Corp. WHAT IS IT?? ------------ AdLogo is a PCBoard utility that will add your BBS's ZIP 'Logo' (ZipComment) to those files that are located on your CD-ROM. You say that you don't have a CD-ROM? No problem. After a period of time (Months, Years) you have problably changed your ZipComment at least a few times and only those files that have been received since the last time your have changed your logo, will contain it. AdLogo will also change those outdated ZipComments (from herein called 'Logo') to your most recent 'Logo'. WHAT OTHER PURPOSE DOES IT HAVE? -------------------------------- Great question! Let's say you have 2000 files on your board that are downloadable files and each of those files contains your board's 'Logo'. If the average size of each 'Logo' that is contained in those files is 2000 bytes (or 2K). We then take 2000 times the size of the 'Logo' and that comes out to be a total of 4meg!! 4meg of space wasted JUST by those files containing your board's 'Logo'. Plus, this 4meg figure is increased EVERYTIME a new file is placed on your system! Well, with AdLogo, you can gain back that wasted 4meg+ and STILL have every ZIP file that is downloaded by your users contain your board's 'Logo' by simply removing the current 'Logo' from all of those files. (This may sound like a big job, however, it isn't. There are shareware utils that will make this job painless!) HOW? --- AdLogo will add your board's 'Logo' to each .ZIP file that a user chooses to download RIGHT before the transfer is started. AdLogo v1.4ßeta Page 2 OPERATION --------- AdLogo is placed is all of your board's PCBS?.BAT files one line before the command line for the transfer protocol. When PCBoard Shell's out to the batch file, AdLogo will do the following: 1) First it will determind if the transfer is a SIGNLE file download or a BATCH downlaod. 2) It will then check each file and determine if it/they are located on a MATCHED CD-ROM (or MATCH HARD DRIVE, herein called CD-ROM) 3) If any of the files are on the CD-ROM, it will then copy the file over to a TEMP directory, and add your board's comment to each file. If the file(s) is/are not a .ZIP, or not on a MATCHED CD-ROM, the file(s) are not touched in anyway. SYNTAX ------ AdLogo <CFGFILE> %NODE% %3 CFGFILE -- is the full path and filename of the configuration file that you are using. This .CFG file can be named valid DOS filename (ie: C:\PCB\ADLOGO.CFG) (See end of docs for format of .CFG file) %NODE% -- this is the enviroment NODE setting. You probably already have this setting defined in each of your board's BOARD.BAT file. However, if you do not, simply add a line somewhere before the PCB145.EXE command like this: SET NODE=n (where 'n' is the number for this node's nodes BOARD.BAT file-Single Node Systems, use 1) %3 -- Place %3 as the last argument on the AdLogo command line. This is the filename, or text file of the paths of the filenames in a batch transfer, that PCBoard passes to the PCBS?.BAT files An example of the AdLogo command line would be like this: AdLogo C:\PCB\ADLOGO.CFG %NODE% %3 AdLogo v1.4ßeta Page 3 INSTALLATION ------------ Installing AdLogo into your system is easy and should take no more than 10 minutes! First, decide what drive you are going to place your TEMP directory on. (HINT: Choose your FASTEST hard drive!). Then choose the name of your TEMP directory. You call this directory ANYTHING you wish, as long as it is a valid DOS directory name. Now create the TEMP directory on the drive your chose. NOTE: If you are running a Multi-Node system, you MUST create different TEMP directory for each Node! (ie N:\TEMP1, N:\TEMP2, etc...) If you are running a SINGLE Node system, you MUST create the directory with the number 1 as the last character! (ie: N:\TEMP1) Second, copy AdLOGO.EXE to a directory that is defined in your DOS PATH statement. (HINT: For FASTEST execution, try to place AdLogo.exe in one of the FIRST directories listed in your PATH statement.) Third, edit each of your PCBSZ.BAT files. If you have added other protocols to your system, you edit these as well. However, we will use PCBSZ.BAT (Which is the ZModem download batch file for the examples). The first thing we you will need to do is place your AdLogo command line right before the DSZ command line. Here is an example of what we are doing: PCBSZ.BAT before AdLogo: @echo off if exist pcberr.fil del pcberr.fil if exist pcbdsz.lgo del pcbdsz.log DSZ port %1 handshake both pB4096 estimate 0 %5 z sz -r %3 PCBSZ.BAT After adding AdLogo @echo off if exist pcberr.fil del pcberr.fil if exist pcbdsz.log del pcbdsz.log AdLogo C:\PCB\ADLOGO.CFG %NODE% %3 DSZ port %1 etc.... AdLogo v1.4ßeta Page 4 Now we must change the %3 in the DSZ command line to read '@%DRIVE%ADLOGO.LST' (without the quotes). DSZ port %1 handshake BOTH pB4096 estimate 0 %5 z sz -r @%DRIVE%ADLOGO.LST NOTE: In each of your node's BOARD.BAT file, you must create a SET DRIVE=n enviroment setting where 'n' is the DRIVE for that node. (ie: SET DRIVE=C:) (Don't worry if this line happens to go past 80 characters.) Why in the world are we changing that for, you ask?!?! I will explain AdLogo workings in a little more detail after the Installation! Now, we need to add three (3) lines after the DSZ command line. First, add these two lines: if exist pcbdsz.lst del pcbdsz.lst if exist adlogo.lst del adlogo.lst And last, we have to add one more DEL command to the batch file. if exist n:\temp%NODE%\*.zip del n:\temp%NODE%\*.zip This will remove any files that were moved over to the TEMP directory by AdLogo. Your new PCBSZ.BAT file should look like this.. @echo off if exist pcberr.fil del pcberr.fil if exist pcbdsz.log del pcbdsz.log AdLogo C:\PCB\ADLOGO.CFG %NODE% %3 DSZ port %1 ..... @ADLOGO.LST if exist pcbdsz.lst del pcbdsz.lst if exist adlogo.lst del adlogo.lst if exist n:\temp%NODE%\*.zip del n:\temp%NODE%\*.zip That's it!! Save your new PCBSZ.BAT file it's complete! If you have added other external protocols to your PCBoard system, you can follow the same instructions above to add AdLogo and it's workings to all of your external protocol's batch files. Just make sure that the AdLogo command line is somewhere BEFORE the command line for the external protocol and that the last three lines are added at the end. Ooops, one more thing, PKZip.EXE must be in one of your DOS'S PATHS! AdLogo v1.4ßeta Page 5 HOW IT WORKS ------------ AdLogo first determines if the transfer is a SINGLE file transfer or a BATCH transfer. If it is a SIGNLE file transfer, AdLogo will then read the %3 parameter that is passed to it and determine if that file is located on one of the Drives that is pointed to by <CD-ROM>. If the file IS on a MATCHED drive, AdLogo will copy the file over to the TEMP directory, pointed to by <TEMPDIR> AND %NODE%, and then will execute PKZip and add your board's 'Logo' to that file. AdLogo will then create a file called ADLOGO.LST in the current PCB Node's directory, and write the new path of the file that contians your board's 'Logo'. AdLogo will then exit and the external protocol will then read ADLOGO.LST and begin transfer of that file. If AdLogo detects that a BATCH transfer is about to begin, AdLogo will read each line of PCBDSZ.LST (this is the file that is created by PCBoard for batch transfers). As each line is read, AdLogo will do the same as it does for the SINGLE file transfer. If, during either a SINGLE file or Batch transfer, the file, or any of the files, selected are NOT a .ZIP file, or NOT on a MATCHED drive, AdLogo will simply copy the path of the file to AdLogo.lst. This is why we changed the %3 in the DSZ command line to @ADLOGO.LST. AdLogo will create ADLOGO.LST EVERYTIME it is executed. PROGRAM COMPATABLILTY --------------------- There are some DOORS for PCBoard that have the option of using PCBoard's external protocol batch files to send and receive information. One of these DOORS is the ever popular Qwik Mail Door from SparkWare. With the addition of AdLogo in these selected batch files that QMail may also use, you are probably wondering if AdLogo is compatable with these 'Other Programs'. The answer to this question is YES! For example, a user opens a mail door and wishes to download a mail packet. The door scans for new mail, prepairs it, archives it, and then calls on the PCBSZ.BAT (Zmodem, for this example) to start the file transfer. Even though AdLogo works with ZIP files, AdLogo will detect that the file to be transfered is a mail packet, and will do nothing to that file. It will leave the file in place, and simply pass the parameter of the path of the mail packet file to the external protocol. AdLogo v1.4ßeta Page 6 LEGAL STUFF ----------- As much as we all hate this, I must too add this in just to keep every- thing on the up-and-up! ADLOGO AND ALL OF IT'S ASSOCITATED FILES ARE RELEASED TO THE PUBLIC AS SHAREWARE. TMC SOFTWARE RETAINS ALL COPYRIGHTS TO THESE UTILITIES AND DOCUMENTATIONS. ADLOGO MAY BE DISTRIBUTED TO THE PUBLIC AS LONG AS THE ARCHIVE FILE THAT ADLOGO.EXE IS CONTAINED IN IS ALTERED IN ANYWAY OR FORM. THIS MEANS THAT NO FILES MAY BE ADDED TO THIS ARCHIVE WITHOUT PRIOR WRITTEN CONSENT FROM TMC SOFTWARE DEVELOPMENT. THE EXCEPTION TO THIS IS ONLY TO THE ZIPCOMMENT THAT THIS ARCHIVE CONTIANS. NO BBS ADS IN THE FORM OF TEXT FILES, EXECUTABLE .EXE OR .COM FILES, OR IN ANY OTHER FORM ARE PERMITTED TO BE ADDED. I, MICHAEL J. CAMBRA, TMC SOFTWARE DEVELOPMENT, OTS DEVELOPMENT CORP, ARE IN NO WAY LIABLE FOR ANY DAMAGES, EITHER IN THE FORM OF HARDWARE OR SOFTWARE, TIME LOST, OR MOENY(IES) LOST, DUE TO THE OPERATION OF ADLOGO.EXE AND ITS SUPPLIMENTERY UTILITIES. Adlogo has been put through a number of tests. Many efforts has been placed into the code to prevent any kind of accidental damaging occuring. However, before installing this software, as it is a good practice before installing ANY new software, to make a backup of your important system files. AdLogo v1.4ßeta Page 7 REGISTRATION ------------ AdLogo is SHARWARE. You may try this program out for a period of no more than 30 days from the date of installation. After this 30 period has expired, you are required to either register this software, or remove the software from your system and discontinue its use. The Registration fee for AdLogo v1.4ßeta is currently $15.00 (US). When the first official version is released, the registration fee will incress to $25.00 (US). Upon registering AdLogo, you will receive the following: -- AdLogo ENHANCED version -- Personal Serial Number -- Free future updates. -- Advanced noticed on future updates (Two weeks - Nonßeta versions) -- Complete set of batch files to add to PCBoard for AdLogo to run under XModem, XModem(CRC), 1k-XModem, YModem, & Ymodem/G -- Free One Year access to The "Port of Call" BBS & The 'Port of Call-East' BBS for instant support and the lastest version of AdLogo -- Voice Support To register your copy of AdLogo, print out REGISTER.FRM, complete it, include either a Check or Money Order made out to Michael Cambra, and mail it to: The 'Port of Call-East' c/o Michael Cambra 20 Nonquit Ln. Tiverton, RI. 02878-4814 ATTN: TMC SOFTWARE AdLogo v1.4ßeta Page 8 SUPPORT ------- For the lastest updates to support, you can call the following boards: Indiana - The "Port of Call" BBS (219)-763-2091 <CompuCom> (219)-763-1940 <HST> - Registered Users Only Join Conference # 69 Address Messages to MIKE CAMBRA Rhode Island - The 'Port of Call-East' (401)-624-6541 <v.32bis> Address Messages to SYSOP Join Conference #216 Address Messages to SYSOP or MIKE CAMBRA AdLogo will be released as ADLG*.ZIP (*= Version number, release number, & B for Beta versions) Or, you can contact me by E-Mail via the following Networks: NorthAmericaNet (NANET) MIKE CAMBRA New England Net (NENET) MIKE CMABRA Medical Net (MEDINET) MIKE CAMBRA AdLogo v1.4ßeta Page 9 ACKNOWLEDGEMENTS ---------------- I wish to thank Brian Cload, Sysop of The "Port of Call" BBS for all the help and support he has given me during the ßeta testing of AdLogo and putting it thru all the tests and finding all those 'Typos' in the docs! Guess that's what happens when your looking at the code for 13 hours stright! TRADEMARKS ---------- PCBoard...............................Clark Development Co. Qwik Mail Door (QMail)................Sparkware PKZip.................................PKWare, Inc. North America Net.....................Canada Remotes Systems New England Net.......................Mike Labbe/Eagle's Nest Network Medical Net...........................Gary Hedberg DSZ...................................Omen Tech, Inc. HS/Link...............................Sam H. Smith/Tool Shop BBS OTS Software Development Corp.........Brian Cload/ The "Port of Call" BBS AdLogo v1.4ßeta Page 10 .CFG FILE --------- The .CFG file for AdLogo is a simple text file made up of a total of 8 lines. Any text editor can be used to create/edit this file. The format of the file is as follows: Line 1 - Your Name (32 chars max) Line 2 - Serial # (00000 if UNREGISTERED) Line 3 - PassCode (0000000000 if UNREGISTERED) Line 4 - CD-ROM (or Hard Drive) Drive Letters Line 5 - TEMP directory Line 6 - FULL Path & Filename of ZipComment (BBS LOGO) Line 7 - FULL PAth and Filename of Callers Log file (Do NOT Place a node number here if running MultiNode!) Line 8 - Y or N (Y=MultiNode System, N=Single Node) A Sample .CFG file is included in the archive. You can simply edit this file as needed. However, Line 2 MUST be five (5) 0's (Zeros) and Line 3 MUST be ten (10) 0's (zeros) if you have not registered your copy of AdLogo. After editing this file, copy it to the directory the same directory where you placed AdLogo.EXE. REMEMBER, even though AdLogo.exe and AdLogo.CFG (or whatever you name your configuartion file), you MUST give the AdLogo commnad line the FULL DRIVE:\PATH\FILENAME.EXT of this file!!